home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / clipper / nftroff.zip / 12.tr < prev    next >
Text File  |  1991-11-21  |  29KB  |  1,749 lines
  1. .de }n
  2. .bp
  3. .sp .5i
  4. ..
  5. .wh -.8i }n
  6. .sp .5i
  7. .po -.4i
  8. .ll 7.5i
  9. .ps 9
  10. .vs 9
  11. .in 0i
  12. .ta 1.63265i
  13. .sp 2
  14. .ne 20
  15. .ps +3
  16. .vs +3
  17. FT_ENDCAP()    Cancel a specific NetWare print queue capture
  18. .br
  19. .ta
  20. .in 0.08i
  21. .ps -3
  22. .vs -3
  23. .sp 2
  24. \fBFT_ENDCAP()
  25. Cancel a specific NetWare print queue capture
  26. .in 0i
  27. .br
  28. \l'6.24i'
  29. .br
  30. .sp
  31. .in 0.08i
  32. \fBSyntax
  33. .sp
  34. .in 0.4i
  35. \fBFT_ENDCAP( [ <nLPTPortNumber> ] ) -> lResult
  36. .sp
  37. .in 0.08i
  38. \fBArguments
  39. .sp
  40. .in 0.4i
  41. \fB<nLPTPortNumber>\fR is the captured LPT port to cancel\.  If the
  42. parameter is omitted, the default port of LPT1: is used\.
  43. .sp
  44. .in 0.08i
  45. \fBReturns
  46. .sp
  47. .in 0.4i
  48. \.T\. if successful
  49. .sp
  50. .in 0.08i
  51. \fBDescription
  52. .sp
  53. .in 0.32i
  54. This routine is used to close a specific capture on the specified LPT
  55. port\.  When this command is issued, the LPT port is no longer redirected
  56. to the print queue, and any information waiting in queue to be printed
  57. will be printed\.
  58. .sp
  59. This routine was designed and written for Advanced NetWare 286 v 2\.1 or
  60. NetWare 386 v 3\.0 or better\.  It has been tested on Advanced NetWare 286
  61. v 2\.15 rev A & C and NetWare 386 v 3\.0\.
  62. .sp
  63. This source code was written for Microsoft Macro Assembler v 5\.1\.  It
  64. should work with any assembler with minor modifications\.
  65. .sp
  66. .in 0.08i
  67. \fBExamples
  68. .sp
  69. .in 0.32i
  70. .br
  71. (in DOS)
  72. .br
  73. F:>CAPTURE S=ServerName Q=PrintQueueName T=0 L=2
  74. .br
  75. Device LPT2: re-routed to queue PrintQueueName on server ServerName\.
  76. .br
  77. F:>CAPTURE S=ServerName Q=PrintQueueName T=0 L=1
  78. .br
  79. Device LPT1: re-routed to queue PrintQueueName on server ServerName\.
  80. .sp
  81. .br
  82. (in your Clipper application)
  83. .br
  84. FT_ENDCAP(2) // Closes LPT2: capture, and flushes print buffer
  85. .br
  86. \.\.\.
  87. .br
  88. \.\.\.
  89. .ta 1.04i
  90. .br
  91. FT_ENDCAP()    // Closes LPT1: (default) capture, and flushes
  92. .br
  93. .ta
  94. .in 1.36i
  95. .ta 0.48i
  96. .br
  97. //    print buffer
  98. .br
  99. .ta
  100. .sp
  101. .in 0.08i
  102. \fBSource:\fR ENDCAP\.ASM
  103. .sp
  104. \fBAuthor:\fR James R\. Zack
  105. .in 0i
  106. .ta 1.63265i
  107. .sp 2
  108. .ne 20
  109. .ps +3
  110. .vs +3
  111. FT_LOGOUT()    Logout from all currently connected NetWare file servers
  112. .br
  113. .ta
  114. .in 0.08i
  115. .ps -3
  116. .vs -3
  117. .sp 2
  118. \fBFT_LOGOUT()
  119. Logout from all currently connected NetWare file servers
  120. .in 0i
  121. .br
  122. \l'6.24i'
  123. .br
  124. .sp
  125. .in 0.08i
  126. \fBSyntax
  127. .sp
  128. .in 0.4i
  129. \fBFT_LOGOUT() -> NIL
  130. .sp
  131. .in 0.08i
  132. \fBArguments
  133. .sp
  134. .in 0.4i
  135. None
  136. .sp
  137. .in 0.08i
  138. \fBReturns
  139. .sp
  140. .in 0.4i
  141. NIL
  142. .sp
  143. .in 0.08i
  144. \fBDescription
  145. .sp
  146. .in 0.32i
  147. This routine is used to log the current user out of all connected file
  148. servers and return control back to Clipper\.  This is handy for writing
  149. your own login screens in Clipper\.  After the FT_LOGOUT() function is
  150. called, you could have a login screen come up, and the users would
  151. never see the DOS prompt again!
  152. .sp
  153. This routine was designed and written for Advanced NetWare 286 v 2\.0 or
  154. NetWare 386 v 3\.0 or better\.  It has been tested on Advanced NetWare 286
  155. v 2\.15 rev A & C, NetWare 386 v 3\.0\.
  156. .sp
  157. Written in Microsoft MASM v5\.1
  158. .sp
  159. .in 0.08i
  160. \fBExamples
  161. .sp
  162. .in 0.32i
  163. .br
  164. FT_LOGOUT()
  165. .br
  166. DO LOGINPRG
  167. .sp
  168. .in 0.08i
  169. \fBSource:\fR LOGOUT\.ASM
  170. .sp
  171. \fBAuthor:\fR James R\. Zack
  172. .in 0i
  173. .ta 1.63265i
  174. .sp 2
  175. .ne 20
  176. .ps +3
  177. .vs +3
  178. FT_NOVDMP2()    Determine Novell server\'s dynamic memory area 2 availability
  179. .br
  180. .ta
  181. .in 0.08i
  182. .ps -3
  183. .vs -3
  184. .sp 2
  185. \fBFT_NOVDMP2()
  186. Determine Novell server\'s dynamic memory area 2 availability
  187. .in 0i
  188. .br
  189. \l'6.24i'
  190. .br
  191. .sp
  192. .in 0.08i
  193. \fBSyntax
  194. .sp
  195. .in 0.32i
  196. \fBFT_NOVDMP2() -> nDMP2
  197. .sp
  198. .in 0.08i
  199. \fBArguments
  200. .sp
  201. .in 0.32i
  202. None
  203. .sp
  204. .in 0.08i
  205. \fBReturns
  206. .sp
  207. .in 0.32i
  208. The total available dynamic memory area 2 on current server, in bytes\.
  209. .sp
  210. .in 0.08i
  211. \fBDescription
  212. .sp
  213. .in 0.24i
  214. This function is used primarily on Novell 2\.15 TTS Servers\.  Dynamic
  215. Memory area 2 is where the transaction tracking takes place\.  This
  216. function allows you to query the ability of the server to handle any
  217. transactions you may wish to start\.  (I personally don\'t let the area
  218. fall below 8K)\.  It is generally only useful in large batch situations
  219. and if you are using NETLIB\'s TTS capability\.
  220. .sp
  221. .sp
  222. .in 0.08i
  223. \fBExamples
  224. .sp
  225. .in 0.24i
  226. .ta 1.44i
  227. .br
  228. t_trans(ON)    // Netlib function
  229. .br
  230. .ta
  231. .br
  232. DO WHILE FT_NOVDMP2() > 8000 \.AND\. ! Eof()
  233. .sp
  234. .in 0.48i
  235. .br
  236. REPLACE foo WITH \'bar\'
  237. .br
  238. SKIP
  239. .sp
  240. .in 0.24i
  241. .br
  242. ENDDO
  243. .br
  244. t_trans(OFF)
  245. .sp
  246. .sp
  247. .in 0.08i
  248. \fBSource:\fR NOVDMP2\.ASM
  249. .sp
  250. \fBAuthor:\fR David Minter
  251. .in 0i
  252. .ta 1.63265i
  253. .sp 2
  254. .ne 20
  255. .ps +3
  256. .vs +3
  257. FT_NOVPURGE()    Purge all deleted files on a Novell server
  258. .br
  259. .ta
  260. .in 0.08i
  261. .ps -3
  262. .vs -3
  263. .sp 2
  264. \fBFT_NOVPURGE()
  265. Purge all deleted files on a Novell server
  266. .in 0i
  267. .br
  268. \l'6.24i'
  269. .br
  270. .sp
  271. .in 0.08i
  272. \fBSyntax
  273. .sp
  274. .in 0.32i
  275. \fBFT_NOVPURGE() -> lTemp
  276. .sp
  277. .in 0.08i
  278. \fBArguments
  279. .sp
  280. .in 0.32i
  281. None
  282. .sp
  283. .in 0.08i
  284. \fBReturns
  285. .sp
  286. .in 0.32i
  287. \.T\. if successful, otherwise \.F\.
  288. .sp
  289. .in 0.08i
  290. \fBDescription
  291. .sp
  292. .in 0.24i
  293. This function is to purge those files that a workstation has
  294. previously deleted\.  This function only works on a Novell network\.
  295. .sp
  296. .in 0.08i
  297. \fBExamples
  298. .sp
  299. .in 0.24i
  300. .br
  301. ERASE FILE foo\.bar
  302. .br
  303. ERASE FILE foo2\.bar
  304. .br
  305. ERASE FILE foo3\.bar
  306. .br
  307. ? FT_NOVPURGE()
  308. .sp
  309. .in 0.08i
  310. \fBSource:\fR NOVPURGE\.ASM
  311. .sp
  312. \fBAuthor:\fR David Minter
  313. .in 0i
  314. .ta 1.63265i
  315. .sp 2
  316. .ne 20
  317. .ps +3
  318. .vs +3
  319. FT_NWLSTAT()    Return the current Novell NetWare logical station number
  320. .br
  321. .ta
  322. .in 0.08i
  323. .ps -3
  324. .vs -3
  325. .sp 2
  326. \fBFT_NWLSTAT()
  327. Return the current Novell NetWare logical station number
  328. .in 0i
  329. .br
  330. \l'6.24i'
  331. .br
  332. .sp
  333. .in 0.08i
  334. \fBSyntax
  335. .sp
  336. .in 0.4i
  337. \fBFT_NWLSTAT() -> nStatNum
  338. .sp
  339. .in 0.08i
  340. \fBArguments
  341. .sp
  342. .in 0.4i
  343. None
  344. .sp
  345. .in 0.08i
  346. \fBReturns
  347. .sp
  348. .in 0.4i
  349. A numeric corresponding to the current logical station number
  350. assigned by NetWare\.
  351. .sp
  352. .in 0.08i
  353. \fBDescription
  354. .sp
  355. .in 0.4i
  356. In order to find out information about a particular node logged
  357. in to a NetWare server, you will need the logical
  358. .ta 4.32i
  359. station number, also known as a "connection number\."    This
  360. .br
  361. .ta
  362. function will return that number\.  This will be a number from 1 to 100
  363. under NetWare 286, or from 1 to 250 under NetWare 386\.  This is *not*
  364. the same as a physical station number\.
  365. .sp
  366. This function requires FT_INT86()\.
  367. .sp
  368. This function does NOT test for the existence of the NetWare shell\.
  369. The behavior is undefined if no shell is loaded\.
  370. .sp
  371. .in 0.08i
  372. \fBExamples
  373. .sp
  374. .in 0.4i
  375. QOut( "Logical station: " + str( FT_NWLSTAT() ) )
  376. .sp
  377. .in 0.08i
  378. \fBSource:\fR NWLSTAT\.PRG
  379. .sp
  380. \fBAuthor:\fR Glenn Scott
  381. .in 0i
  382. .sp 2
  383. .ne 20
  384. .ps +3
  385. .vs +3
  386. FT_NWSEMCLOSE() Close a NetWare semaphore
  387. .br
  388. .in 0.08i
  389. .ps -3
  390. .vs -3
  391. .sp 2
  392. \fBFT_NWSEMCLOSE()
  393. Close a NetWare semaphore
  394. .in 0i
  395. .br
  396. \l'6.24i'
  397. .br
  398. .sp
  399. .in 0.08i
  400. \fBSyntax
  401. .sp
  402. .in 0.4i
  403. .ta 2.24i
  404. \fBFT_NWSEMCLOSE( <nHandle> )    -> nRc
  405. .br
  406. .ta
  407. .sp
  408. .in 0.08i
  409. \fBArguments
  410. .sp
  411. .in 0.4i
  412. \fB<nHandle>\fR is the semaphore handle, returned from a previous call
  413. to FT_NWSEMOPEN()\.
  414. .sp
  415. .in 0.08i
  416. \fBReturns
  417. .sp
  418. .in 0.4i
  419. nRc, a numeric, as follows:
  420. .sp
  421. .in 0.96i
  422. 0 - success
  423. .in 0.8i
  424. 255 - invalid semaphore handle
  425. .sp
  426. .in 0.08i
  427. \fBDescription
  428. .sp
  429. .in 0.4i
  430. Call FT_NWSEMCLOSE() when the app is finished\.  This decrements
  431. the open count for the semaphore\.  If the open count hits zero,
  432. the semaphore is deleted by NetWare\.
  433. .sp
  434. .in 0.08i
  435. \fBExamples
  436. .sp
  437. .in 0.4i
  438. QOUT( "Close returns:  " + STR( FT_NWSEMCLOSE( nHandle ) ) )
  439. .sp
  440. .in 0.08i
  441. \fBSource:\fR NWSEM\.PRG
  442. .sp
  443. \fBAuthor:\fR Glenn Scott
  444. .in 0i
  445. .sp
  446. .in 1.5i
  447. .ti -1.5i
  448. .ta 1.5i
  449. .ft B
  450. See Also:    
  451. .ft R
  452. FT_NWSEMOPEN()
  453. , FT_NWSEMEX()
  454. , FT_NWSEMWAIT()
  455. , FT_NWSEMSIG()
  456. , FT_NWSEMLOCK()
  457. .ta 1.63265i
  458. .in 0i
  459. .sp 2
  460. .ne 20
  461. .ps +3
  462. .vs +3
  463. FT_NWSEMEX()    Examine a NetWare semaphore\'s value and open count
  464. .br
  465. .ta
  466. .in 0.08i
  467. .ps -3
  468. .vs -3
  469. .sp 2
  470. \fBFT_NWSEMEX()
  471. Examine a NetWare semaphore\'s value and open count
  472. .in 0i
  473. .br
  474. \l'6.24i'
  475. .br
  476. .sp
  477. .in 0.08i
  478. \fBSyntax
  479. .sp
  480. .in 0.48i
  481. \fBFT_NWSEMEX( <nHandle>, <@nValue>, <@nOpenCnt> ) -> nRc
  482. .sp
  483. .in 0.08i
  484. \fBArguments
  485. .sp
  486. .in 0.48i
  487. \fB<nHandle>\fR is the semaphore handle, returned from a previous call
  488. to FT_NWSEMOPEN()\.
  489. .sp
  490. \fB<@nValue>\fR will get the current semaphore value\.  THIS NUMERIC
  491. ARGUMENT MUST BE PASSED BY REFERENCE!
  492. .sp
  493. \fB<@nOpenCnt>\fR will get the current number of workstations
  494. that have opened the semaphore\.  THIS NUMERIC ARGUMENT MUST BE
  495. PASSED BY REFERENCE!
  496. .sp
  497. .in 0.08i
  498. \fBReturns
  499. .sp
  500. .in 0.48i
  501. nRc, a numeric, as follows:
  502. .sp
  503. .in 0.96i
  504. 0 - success
  505. .in 0.8i
  506. 255 - invalid semaphore handle
  507. .sp
  508. .in 0.48i
  509. In addition, nValue w